home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmstore.z / pmstore
Text File  |  1997-04-03  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMSSSSTTTTOOOORRRREEEE((((1111))))                                                          PPPPMMMMSSSSTTTTOOOORRRREEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmssssttttoooorrrreeee - modify performance metric values
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmssssttttoooorrrreeee [----hhhh _h_o_s_t] [----iiii _i_n_s_t_a_n_c_e_s] [----nnnn _n_a_m_e_s_p_a_c_e] _m_e_t_r_i_c_n_a_m_e _v_a_l_u_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      Under certain circumstances, it is useful to be able to modify the values
  16.      of performance metrics, e.g. to re-initialize counters or to assign new
  17.      values to metrics that act as control variables.
  18.  
  19.      ppppmmmmssssttttoooorrrreeee changes the current values for the nominated instances of a
  20.      single performance metric, as identified by _m_e_t_r_i_c_n_a_m_e and the list of
  21.      instance identifiers following the ----iiii argument.  _i_n_s_t_a_n_c_e_s must be a
  22.      single argument, with elements of the list separated by commas and/or
  23.      white space.  By default all instances of _m_e_t_r_i_c_n_a_m_e will be updated.
  24.  
  25.      Normally ppppmmmmssssttttoooorrrreeee operates on the default Performance Metrics Namespace
  26.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  27.      loaded from the file _n_a_m_e_s_p_a_c_e.
  28.  
  29.      Unless directed to another host by the ----hhhh option, ppppmmmmssssttttoooorrrreeee will interact
  30.      with the PMCD on the local host.
  31.  
  32.      The interpretation of _v_a_l_u_e is dependent on the syntax used in it's
  33.      specification and the underlying data type of _m_e_t_r_i_c_n_a_m_e, as follows.
  34.  
  35.      1.  If the metric has an iiiinnnntttteeeeggggeeeerrrr type, then _v_a_l_u_e should be an optional
  36.          leading hyphen, followed either by decimal digits or ``0x'' and some
  37.          hexadecimal digits.  ``0X'' is also acceptable in lieu of ``0x''.
  38.          See ssssttttrrrrttttoooollll(3C) and the related routines.
  39.  
  40.      2.  If the metric has a ffffllllooooaaaattttiiiinnnngggg ppppooooiiiinnnntttt type, then _v_a_l_u_e should be either
  41.          in the form of an integer described above, or a fixed point number,
  42.          or a number in scientific notation.  See ssssttttrrrrttttoooodddd(3C).
  43.  
  44.      3.  If the metric has a ssssttttrrrriiiinnnngggg type, then _v_a_l_u_e is interpreted as a
  45.          literal string of ASCII characters.
  46.  
  47.      4.  If the metric has an aaaaggggggggrrrreeeeggggaaaatttteeee type, then an attempt is made to
  48.          interpret _v_a_l_u_e as an integer, else a floating point number, else a
  49.          string.  In the first two cases, the minimal word length encoding is
  50.          used, e.g.  ``123'' would be interpreted as a 4-byte aggregate,
  51.          ``0x100000000'' would be interpreted as an 8-byte aggregate.
  52.  
  53.      The output reports the old value and the new value for each updated
  54.      instance of the requested metric.
  55.  
  56. FFFFIIIILLLLEEEESSSS
  57.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMSSSSTTTTOOOORRRREEEE((((1111))))                                                          PPPPMMMMSSSSTTTTOOOORRRREEEE((((1111))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmvvvvaaaallll(1), ssssttttrrrrttttoooodddd(3C) and ssssttttrrrrttttoooollll(3C).
  76.  
  77. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  78.      Two messages indicate a mismatch between the internal data type for
  79.      _m_e_t_r_i_c_n_a_m_e and the _v_a_l_u_e provided.
  80.  
  81.      The value "???" is out of range for the data type (PM_TYPE_...)
  82.  
  83.      The value "???" is incompatible with the data type (PM_TYPE_...)
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.